home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / src / sgml / sgml2latex-format.1.3.tar.Z / sgml2latex-format.1.3.tar / test / test.sgml < prev    next >
SGML Document  |  1993-10-12  |  8KB
  1. <!doctype qwertz system 
  2. [
  3. <!entity TeX "TeX" >   
  4. <!entity LaTeX "LaTeX">
  5. <!entity et "&etago;">
  6. <!entity lhead "The <tt/qwertz/ Document Types">
  7. ]>
  8.  
  9. <report opts="11pt">
  10. <title>The <tt/qwertz/ SGML Document Types
  11. <subtitle>(Version 1.1 Reference Manual)
  12. <author>Tom Gordon
  13. <inst>The <tt/qwertz/ Project &nl
  14. Institute for Applied Information Technology (F3) &nl&nl
  15. German National Research Center &nl
  16. for Computer Science (GMD)
  17.  
  18. <chapt>Why Not Just Use &LaTeX;?</heading>
  19.  
  20. <p>The <tt/qwertz/ document types are a set of Standard Generalized
  21. Markup Language (SGML) document type definitions (DTDs) for articles,
  22. reports, books, letters, notes, slides (or overhead transparencies),
  23. bibliographies, and manual pages.  Except for manual pages, the
  24. document types have been heavily influenced by the &LaTeX document
  25. types of the same names <cite id="Lamport86">, so &LaTeX users should
  26. feel right at home.  Indeed, we presently translate most <tt/qwertz/
  27. documents into &LaTeX for printing and the &LaTeX produced is quite
  28. readable by anyone familiar with &LaTeX;.
  29.  
  30. …
  31.  
  32. <chapt>The <tt/qwertz/ Document Type Definition</heading>
  33. <header><lhead>&lhead<rhead>The <tt/qwertz/ DTD</header>
  34.  
  35. <p> &hellip
  36.  
  37. We will be making use of several <em/parameter entities/ in this
  38. DTD:
  39.  
  40. <code>
  41. <!entity % emph 
  42.     " em | it | bf | sf | sl | tt " >
  43.  
  44. <!entity % inline 
  45.     " f | x | %emph; | sq | label | ref | 
  46.           pageref | cite | ncite " >
  47. </code>
  48.  
  49. &hellip
  50.  
  51. <sect> General Purpose Entities and Elements</heading>
  52. <header><lhead>&lhead<rhead>General Purpose Entities</header>
  53.  
  54. <p> &hellip
  55.  
  56. When may it be necessary to use of an entity reference to produce
  57. some character?  There are three cases to watch out for:
  58.  
  59. <descrip><tag>SGML Concrete Syntax Delimiters.</tag>
  60.  
  61. Although the SGML standard allows alternative concrete syntaxes to
  62. be defined, we use the so-called <em/reference concrete syntax/ in
  63. the <tt/qwertz/ document types.  &hellip
  64.  
  65. <tag>SGML Short Reference Delimiters.</tag>
  66.  
  67. In SGML document types <em/short reference maps/ may be defined
  68. which allow single characters to be interpreted as arbitrarily complex
  69. sequences of characters, including SGML tags and entity references. &hellip
  70.  
  71. <verb>
  72. " # % ' ( ) * + , - : ; = @ [ ] ^ _ { | } ~
  73. </verb>
  74.  
  75. For each of these characters, there is an SGML entity which may be
  76. used to generate the ASCII character in the printed document, listed
  77. in table <ref id="GPC">. <em/Usually, it will not be necessary to use these
  78. entities; the character can simply be typed and will be interpreted
  79. literally./ However, …
  80.  
  81. <tag>&TeX Special Characters.</tag>
  82.  
  83. Ideally, it should be possible to hide the conventions of the
  84. underlying formatting system completely.  In fact, SGML parsers which
  85. implement the full ISO standard have a feature which makes this
  86. possible. &hellip
  87.  
  88. </descrip>
  89.  
  90. <sect1>Spacing, Dashes and Ellipsis
  91. <header><lhead>&lhead<rhead>Spacing, Dashes and Ellipsis</header>
  92.  
  93. <p> &hellip
  94.  
  95. There are also three different kinds of dashes: <tt/hyphen/
  96. which was already mentioned above, is to be used for intra-word dashes, as
  97. in the word "intra-word".<footnote>However, the <tt/hyphen/ entity
  98. was not actually necessary here, as the - character was not being used
  99. in this context as a short reference.</footnote>
  100.  
  101. <p> &hellip
  102.  
  103. <sect1> Foreign Characters
  104. <header><lhead>&lhead<rhead>Foreign Characters</header>
  105.  
  106. <p> There are a large set of entities for other Western European
  107. languages.  Altogether, there are entities for almost all of the
  108. foreign language characters in ISO 8859, the Latin 1 character set for
  109. Western European languages.<footnote/Only the four
  110. Icelandic characters are missing./ &hellip
  111.  
  112. <table>
  113. <tabular ca="ll|ll|ll|ll">
  114. AElig   |    Æ  |
  115. Aacute  |    ┴ |
  116. Acirc    |    ┬ |
  117. Ae      |     ─    @
  118. Ntilde  |    Ñ |
  119. Oacute  |    ╙ |
  120. Ocirc   |    ╘ |
  121. Oe      |       ╓     @
  122. Ue      |       ▄     |
  123. Ugrave  |    ┘ |
  124. Uuml    |    ▄ |
  125. Yacute  |    ▌ @
  126. aacute  |    ß |
  127. acirc   |    Γ |
  128. ae      |       Σ | 
  129. aelig   |    æ  @
  130. oe      |       ÷   | 
  131. ograve  |    ≥ |
  132. oslash  |    ø |
  133. otilde  |    õ @
  134. sz      |       ▀       | 
  135. szlig   |    ▀  |
  136. thinsp  |             |
  137. tilde   |       &tilde  @
  138. times   |       ×  |
  139. uacute  |    · |
  140. ucirc   |    √ |
  141. ue      |       ⁿ 
  142. </tabular>
  143. <caption><label id="GPC"> (Some) General Purpose Characters</caption>
  144. </table>
  145.  
  146. <p>  &hellip
  147.  
  148. <sect1>Sentences, Paragraphs, Footnotes and Emphasis
  149. <header>
  150. <lhead>&lhead
  151. <rhead>Sentences &hellip Emphasis
  152. </header>
  153.  
  154. <p> &hellip
  155.  
  156. Sentences or phrases within paragraphs can be emphasized in a
  157. number of ways.  The <tt/em/ tag is used to choose the default form
  158. of emphasis, which is usually <em/italic/ type, but depends on the
  159. style of the background text.  If the background text is formatted in
  160. italics type, as it usually is in definitions, for example, than
  161. emphasized text will be formatted using a plain, roman typeface.
  162. However, various forms of emphasis can be explicitly chosen.  These
  163. include: <bf/bold face/ (<tt/bf/), <it/italics/ (<tt/it/),
  164. <sf/sans serif/ (<tt/sf/), <sl/slanted/ (<tt/sl/), and
  165. <tt/typewriter/ (<tt/tt/) styles.
  166.  
  167. <p> &hellip
  168.  
  169. Long quotes are formatted in &LaTeX by indenting the left and
  170. right margins.  For example, <ncite id="Lamport86" note="pp. xiii">:
  171.  
  172. <lq>
  173. <p>The &LaTeX document preparation system is a special version of
  174. Donald Knuth's &TeX program.  &TeX is a sophisticated program designed
  175. to produce high-quality typesetting, especially for mathematical text.
  176. &hellip
  177.  
  178. &LaTeX represents a balance between functionality and ease of use.
  179. Since I implemented most of it myself, there was also a continual
  180. compromise between what I wanted to do and what I could do in a
  181. reasonable amount of time.  &hellip
  182. </lq>
  183.  
  184. <sect1>Lists
  185. <header><lhead>&lhead<rhead>Lists</header>
  186.  
  187. <p> Three types of lists are supported, which differ according to the
  188. type of label used to mark each item in the list.  Use <tt/itemize/
  189. to create a list in which each item is marked with some symbol such as
  190. a dash or bullet. The <tt/enum/ tag is used to create an
  191. enumeration, i.e. a list in which each item is labelled with a number
  192. (or letter) indicating its rank or position in the list. Finally, use
  193. <tt/descrip/ to create a list in which each item is labelled by some
  194. tag of your own choice. Lists of various types can nested.  For
  195. example:
  196.  
  197. <p> &hellip
  198.  
  199. <itemize>
  200. <item> A level one item.
  201. <item> Here's level two 
  202.     <enum>
  203.     <item> A level two item.
  204.     <item> Here's level three:
  205.         <enum>
  206.         <item> A level three item.
  207.         <item> Here's level four:
  208.               <descrip>
  209.               <tag/Red./ Is the color of my true love's hair.
  210.                       <tag/Blue./ Is a property of some movies.
  211.                       <tag/Yellow./ Characterizes some forms of journalism.
  212.                       </descrip>
  213.         <item>A last level three item
  214.         </enum>
  215.     <item> A last level two item
  216.     </enum>
  217. <item>A last level one item.
  218. </itemize>
  219.  
  220. <p> &hellip
  221.  
  222. <sect1>Figures and Tables
  223.  
  224. Encapsulated PostScript graphics can be created using a variety of
  225. different editors.  If you are using Unix with an X11-based graphical
  226. user-interface, you may want to try <tt/idraw/, which stores its
  227. documents directly as Encapsulated PostScript files. Another
  228. interesting X11-based drawing program is <tt/tgif/.
  229.  
  230. <p> &hellip
  231.  
  232. Which would then appear as in figure <ref id="issues">.
  233.  
  234. <figure>
  235.         <eps file="issues">
  236.     <caption><label id="issues">An <tt/idraw/ Drawing </>
  237. </figure>
  238.  
  239. <sect1>Literate Programming
  240.  
  241. <p> The original motivation behind the development of these document
  242. types was to create an environment for literate programming in an
  243. arbitrary programming language similar to Donald Knuth's WEB system
  244. for literate programming in Pascal <cite id="Knuth84">.  &hellip
  245.  
  246. <p> When formatted, spaces and line breaks are preserved:
  247.  
  248. <verb>
  249. main ()
  250. {
  251.         /* This is the famous hello world program */
  252.  
  253.         printf("hello world\n");
  254. }
  255. </verb>
  256.  
  257. <sect1>Mathematical Formulas
  258.  
  259. <p> The <tt/qwertz/ document types include elements for describing
  260. mathematical formulas completely within SGML, similar to the system
  261. described in <cite id="daphne89">.  &hellip
  262.  
  263. <p> So, for example, 
  264.  
  265. <dm>
  266.         <sum><ll>i=1<ul>n<opd>x<inf>i</></sum> =
  267.         <in><ll>0<ul>1<opd>f</in>
  268. </dm>
  269. was typed as:
  270. <verb>
  271. <dm>
  272.         <sum><ll>i=1<ul>n<opd>x<inf>i&et>&et;sum> =
  273.         <in><ll>0<ul>1<opd>f&et;in>
  274. &et;dm>
  275. </verb>
  276.  
  277. <p> &hellip
  278.  
  279. <biblio files="lit">
  280. </report>
  281.  
  282.